Add Codex plugin by adityaoberai · Pull Request #2987 · appwrite/website

adityaoberai · 2026-05-08T15:21:54Z

What does this PR do?

Adds Codex plugin announcment, changelog, and updates docs

Test Plan

Visit /blog/post/announcing-appwrite-codex-plugin, /docs/tooling/ai/ai-dev-tools/codex, /changelog/entry/2026-05-11

Related PRs and Issues

Blocked by appwrite/codex-plugin#1

Have you read the Contributing Guidelines on issues?

Yes

appwrite · 2026-05-08T15:22:05Z

Appwrite Website

Project ID: 69d7efb00023389e8d27

Sites (1)

Site	Status	Logs	Preview	QR
website `69d7f2670014e24571ca`	Failed	View Logs	Preview URL

Website (appwrite/website)

Project ID: 684969cb000a2f6c0a02

Sites (1)

Site	Status	Logs	Preview	QR
website `68496a17000f03d62013`	Queued	View Logs	Preview URL

Tip

Git integration provides automatic deployments with optional PR comments

greptile-apps · 2026-05-08T15:24:06Z

Greptile Summary

This PR adds the Appwrite Codex plugin announcement blog post, a changelog entry, and updates the Codex docs page to include a new plugin-install step, while also adding a parseInline markdown utility that enables rich-text FAQ answers on blog posts.

New content: Blog post, changelog entry, and cover image for the Codex plugin release; docs page restructured to add Step 1 (plugin install) and renumber existing steps accordingly.
parseInline utility (markdown.ts + faq.svelte): A separate MarkdownIt instance renders inline markdown for FAQ answers without block wrappers; a custom link_open rule correctly adds rel="noopener noreferrer" and target="_blank" for external links before injecting the web-link class.
.optimize-cache.json: The new cache entry keys on cover.png while the committed image (and all frontmatter references) use cover.avif; the mismatch means the optimizer will never hit this cache entry for the real asset.

Confidence Score: 5/5

Safe to merge; changes are additive content with a small, well-contained utility addition.

All code changes are straightforward and isolated — a new inline markdown renderer used only for static, author-controlled FAQ content, and markdoc content files. The .optimize-cache.json key mismatch (cover.png vs cover.avif) is the only functional discrepancy, but it degrades cache hits for a single image rather than breaking anything.

.optimize-cache.json — the cache key should match the .avif extension used by the actual committed image and all frontmatter references.

Important Files Changed

Filename	Overview
src/lib/utils/markdown.ts	Adds `parseInline` helper using a separate `MarkdownIt` instance with a custom `link_open` renderer that correctly adds `rel="noopener noreferrer"`, `target="_blank"`, and `class="web-link"` to external links.
src/lib/components/blog/faq.svelte	Pipes FAQ answers through `parseInline` before rendering with `{@html}`, enabling markdown links and formatting in answers; `eslint-disable` comments already present; content is team-authored static frontmatter.
src/routes/docs/tooling/ai/ai-dev-tools/codex/+page.markdoc	Adds a new Step 1 for plugin install, renumbers existing steps 2→3 and 3→4, updates the info box to accurately reflect manual MCP-only setup (removing the misleading skill-copying reference).
src/routes/blog/post/announcing-appwrite-codex-plugin/+page.markdoc	New blog post announcing the Appwrite Codex plugin with a detailed FAQ section; content is well-structured with correct internal links and cover image path pointing to the `.avif` file.
src/routes/changelog/(entries)/2026-05-11.markdoc	New changelog entry for the Codex plugin release, correctly linking to the announcement blog post.
.optimize-cache.json	Cache entry added with `cover.png` path, but the actual image file committed is `cover.avif` — the cache key will never match the real asset.
static/images/blog/announcing-appwrite-codex-plugin/cover.avif	New cover image for the blog post and changelog entry, in `.avif` format consistent with what frontmatter references.

_{Reviews (8): Last reviewed commit: "Add internal links to FAQs" | Re-trigger Greptile}

atharvadeosthale · 2026-05-10T18:14:09Z

+timeToRead: 4
+author: aditya-oberai
+category: announcement
+featured: false


Probably should have FAQ, especially around why API MCP is not supported. We do cover it in the article, but FAQs should be good here in frontmatter

atharvadeosthale · 2026-05-10T18:17:44Z

@adityaoberai I see we're using a PNG and the assets test is failing, let's also fix that.

Co-authored-by: Atharva Deosthale <atharva.deosthale17@gmail.com>

greptile-apps · 2026-05-11T14:02:04Z

  "static/images/blog/announcing-2fa.png": "1df5ba12c2de318f858c36a3804b7170844cb74bdb73e1ea37895d674208b9e0",
  "static/images/blog/announcing-appwrite-arena/cover.png": "3934fbf6ee24c468b715b1839bc49c335a47a68f7fc99a763b109b2446f97379",
  "static/images/blog/announcing-appwrite-claude-code-plugin/cover.png": "334e890b32c20c3a4c7f0878b5908a71a518d983b15b6ee434f9dabb66ee8ecd",
+  "static/images/blog/announcing-appwrite-codex-plugin/cover.png": "6328e3c6089bcdbd7b9187b1e77b1b496a2d1e1a092f1375623fb2512e22c359",


The cache entry references cover.png, but the actual file added in this PR is cover.avif, and the blog post and changelog frontmatter both reference the .avif path. The .png path does not exist in the repo, so this cache entry points to a non-existent file while the real cover image goes untracked — if the optimizer uses this cache to locate or skip images, cover.avif will be processed as uncached on every build and the stale .png entry may trigger a "file not found" error.

Suggested change

"static/images/blog/announcing-appwrite-codex-plugin/cover.png": "6328e3c6089bcdbd7b9187b1e77b1b496a2d1e1a092f1375623fb2512e22c359",

"static/images/blog/announcing-appwrite-codex-plugin/cover.avif": "6328e3c6089bcdbd7b9187b1e77b1b496a2d1e1a092f1375623fb2512e22c359",

adityaoberai added 2 commits May 8, 2026 20:47

Add Codex plugin announcement + changelog + docs update

1303546

Merge branch 'main' into add-codex-plugin

fb626f5

adityaoberai requested a review from atharvadeosthale May 8, 2026 15:21

greptile-apps Bot reviewed May 8, 2026

View reviewed changes

Comment thread src/routes/blog/post/announcing-appwrite-codex-plugin/+page.markdoc

Comment thread src/routes/docs/tooling/ai/ai-dev-tools/codex/+page.markdoc

atharvadeosthale reviewed May 10, 2026

View reviewed changes

Comment thread src/routes/docs/tooling/ai/ai-dev-tools/codex/+page.markdoc Outdated

adityaoberai and others added 4 commits May 11, 2026 17:52

Update src/routes/docs/tooling/ai/ai-dev-tools/codex/+page.markdoc

3c7a7c9

Co-authored-by: Atharva Deosthale <atharva.deosthale17@gmail.com>

Update src/routes/docs/tooling/ai/ai-dev-tools/codex/+page.markdoc

8f04952

update cover

ef0f48b

optimize assets

2f3e595

greptile-apps Bot reviewed May 11, 2026

View reviewed changes

adityaoberai added 4 commits May 11, 2026 19:49

Add FAQs + other edits

fe4f0eb

Merge branch 'main' into add-codex-plugin

eca2052

Allow FAQs to render inline code blocks and links

04dcfef

Add internal links to FAQs

8a9692f

atharvadeosthale approved these changes May 11, 2026

View reviewed changes

adityaoberai merged commit b195a04 into main May 11, 2026
6 of 7 checks passed

adityaoberai deleted the add-codex-plugin branch May 11, 2026 16:09

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add Codex plugin#2987

Add Codex plugin#2987
adityaoberai merged 10 commits into
mainfrom
add-codex-plugin

adityaoberai commented May 8, 2026

Uh oh!

appwrite Bot commented May 8, 2026 •

edited

Loading

Uh oh!

greptile-apps Bot commented May 8, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

atharvadeosthale May 10, 2026

Uh oh!

Uh oh!

atharvadeosthale commented May 10, 2026

Uh oh!

greptile-apps Bot May 11, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

	"static/images/blog/announcing-appwrite-codex-plugin/cover.png": "6328e3c6089bcdbd7b9187b1e77b1b496a2d1e1a092f1375623fb2512e22c359",
	"static/images/blog/announcing-appwrite-codex-plugin/cover.avif": "6328e3c6089bcdbd7b9187b1e77b1b496a2d1e1a092f1375623fb2512e22c359",

Conversation

adityaoberai commented May 8, 2026

What does this PR do?

Test Plan

Related PRs and Issues

Have you read the Contributing Guidelines on issues?

Uh oh!

appwrite Bot commented May 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Appwrite Website

Website (appwrite/website)

Uh oh!

greptile-apps Bot commented May 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Greptile Summary

Confidence Score: 5/5

Important Files Changed

Uh oh!

Uh oh!

Uh oh!

atharvadeosthale May 10, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

atharvadeosthale commented May 10, 2026

Uh oh!

greptile-apps Bot May 11, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

appwrite Bot commented May 8, 2026 •

edited

Loading

greptile-apps Bot commented May 8, 2026 •

edited

Loading